home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / outil179.zip / CONFILE.DOC < prev    next >
Text File  |  1997-04-30  |  5KB  |  124 lines
  1.     CONFILE
  2.  
  3. Opus 1.70 files.bbs to files database converter.
  4.  
  5. When invoked, the following dialog is presented:
  6.  
  7.  > This utility will convert the old style one files.bbs file
  8.  > per area to the new single filesbbs database
  9.  > Do you wish to continue? [Y,n]
  10.  
  11. Answer Y to continue, N to abort.
  12.  
  13.  > Do you wish to include orphan files (files that are in an area,
  14.  > that don't have an entry in the files.bbs) [Y,n]?
  15.  
  16. Orphan files are those files which exist in an area, but they do not
  17. have an entry in the files.bbs. Answer Y if you want them included,
  18. N if you don't want them in the new datbase either.
  19.  
  20.  > Counting the number of downloads and file requests is now supported
  21.  > Are you currently using a utility which supports this function? [Y,n]
  22.  >
  23.  > The count of downloads is usually added to the file description.
  24.  > It is usually at the beginning of the description, but it may also
  25.  > be at the end. It is usually delimited by () or []
  26.  > Is the counter at the Start or at the End of the description? [S,e]
  27.  >
  28.  > Enter the starting delimiter character - usually ( or [
  29.  >
  30.  > Enter the ending delimiter character - usually ) or ]
  31.  >
  32.  > The name of the person who uploaded the file is now also kept
  33.  > with the file. If you're currently using a utility that tracks
  34.  > uploaders, enter the exact text that is in the file descriptions
  35.  > that precedes the name of the uploader i.e. `Uploaded by'
  36.  > TEXT:
  37.  
  38. Enter the text here that CONFILE is to scan for in the file description
  39. comments. Remember that it is case sensitive.
  40.  
  41.  > You have selected the following options:
  42.  > Add orphan files to the database
  43.  > Download count is at start of description
  44.  > and is delimited by `(' and `)'
  45.  > Uploader search text is `Uploaded by'
  46.  > Are these options correct? [Y,n]
  47.  
  48. Only the option you selected will be displayed. If any of them appear
  49. to be incorrect, and the questions will be asked again. You may also wish
  50. to hit CTRL-C to abort the program.
  51.  
  52. CONFILE will create the new files in the directory specified by the
  53. USES FILES statement in the BBS.CTL file. If the USES FILES was not
  54. specified, the files will be created in the PATH SYSTEM directory.
  55. If a BBS.PRM cannot be found to get those directory names, the new
  56. files will be created in the current directory. See the section on
  57. setting up an OPUS environment variable.
  58.  
  59. The new files are:
  60.     FILESBBS.DAT    all the file info and descriptions
  61.     FILESBBS.NDX    file name index
  62.     FILESBBS.ADX    area number index
  63.     DELOLDF.BAT    batch file to delete the old files.bbs files
  64.     CPYOLDF.BAT    batch file to backup the old files.bbs files
  65.  
  66. For CD-ROM users, each file can have it's own directory pointer.
  67. This allows files to show up in whatever area you wish. In order to
  68. take advantage of this feature in the file conversion, insert the
  69. full pathname of the file in front of the file name in the files.bbs
  70. for the area you wish it to show up in. A normal files.bbs entry is:
  71.   AFILE.ZIP  description
  72. Edit this entry to look like:
  73.   P:\dir1\AFILE.ZIP description
  74. and CONFILE will restore it to a normal entry, and save the directory
  75. name, so Opus can find the file.
  76.  
  77. BTW, the same mechanism can be used when you want a file to show up
  78. in more than one area, and you only need to store the file in one
  79. place. This should save some disk space.
  80.  
  81. Another new feature has been added. You can now pick some point
  82. anywhere in the files area, and all new files will be inserted there.
  83. (So when user's want to see what's new, they don't have to go all the
  84. way to the end of the area.)
  85.  
  86.     This is the MS-DOS Utility File area:
  87.  
  88.     > Latest Uploads:
  89.  
  90.     (new files will be inserted here)
  91.     -------------------------------------------------
  92.  
  93.     Archiving programs:
  94.     (the rest of the area files)
  95.  
  96. Confile, ofare, and opus-fam will scan the first character of comment
  97. lines, and when the first > is found, set the HAS_GT flag, and record
  98. the database position in insert_pos. When an @ is found,
  99. the HAS_AT flag is set. I'm handling these flags so that
  100. insert has a higher priority than hide. That way, when insert is
  101. specified, the new files will be seen, and the ability to hide files
  102. at the end of the area can still be used.
  103.  
  104. Since Opus 1.70 allows the system dat files and the user file to be
  105. located in other than the Opus home directory, support has been added
  106. to look up these paths in the Opus prm file.
  107.  
  108. Set up an environment variable labelled OPUS, and specify
  109. the full pathname of the prm file, i.e.
  110. SET OPUS=H:\OP170\BBS.PRM (if your environment space is cramped,
  111. you may leave off the .PRM suffix, the program will add it).
  112. BTW, Doug and I are making the OPUS environment variable
  113. a standard for all the OPUS utilities. If you want the C source,
  114. just ask.
  115.  
  116. If the OPUS environment variable is not set, the program will look
  117. in the current working directory for USER.DAT and SYSMSG.DAT. If
  118. either file is not found, it will then look for BBS.PRM and look
  119. up the paths in there. If none of the above are found, the program
  120. will fail.
  121.  
  122.     John Valentyn 1:114/5@fidonet.org
  123.  
  124.